Hist - Events Data Group

The "Hist - Events" (HistEvent) data group is used to read events from the Emerson event file. The data group reads by date range, index number, or get latest data.

Get latest data: There are three different parameters associated with a Get latest data request, each of which may be combined with the others for different effects:

• Max records to read: Specifies the maximum number of historical records to retrieve.
• Start date: Specifies the oldest date limit. If there is no cached "last record," reading will begin at the indicated start date. If the "last record" has been cached, the start time will be used only if it is later than the cached record time.
• End date: Specifies the most recent date limit.

Get data by index: There are two parameters associated with this selection:

• Starting record index: The number of the record index to start polling from.
• Max records to read: Specifies the maximum number of historical records to retrieve.

Get data by date range: There are two parameters associated with this selection:

• Start date: Specifies the oldest date limit.
• End date: Specifies the most recent date limit.

Example

Click here to see an example of the data group <HistEvent niceName="Hist - Events"> <dgElements secLev="4" type="vrnt"> <Count desc="Event count"/> <DateTime desc="Timestamp"/> <RecVers desc="Rec version" hidden="true"/> <Seq desc="Seq #"/> <RecType desc="Type #" hidden="true"/> <RecTypeT desc="Type" type="string" ref="RecType" mapVal="U107EvtType"/> <SubType desc="Sub-type #" hidden="true"/> <SubTypeT desc="Sub-type" type="string" isRef="1"> <ref prec="0" refOp="opAssignId" deid="SubType"/> <ref prec="1" refOp="opMapToMapVal" deid="RecType" mapVal="MapEvtType"/> </SubTypeT> <UserName desc="ID"/> <ComType desc="Comm type" hidden="true"/> <ComNum desc="Comm #" hidden="true"/> <Tag desc="Parameter"/> <DataType desc="Data type" hidden="true"/> <DataTypeT desc="Data type" type="string" hidden="true" ref="DataType" mapVal="EDataType"/> <ValueOld desc="Old/found value"/> <Value desc="New/left value"/> <MeasTypOld desc="Meas type old #" hidden="true"/> <UnitTypOld desc="Unit type old #" hidden="true"/> <UnitsOld desc="Old/found units"/> <MeasType desc="Meas type new #" hidden="true"/> <UnitType desc="Unit type new#" hidden="true"/> <Units desc="New/left units"/> <Desc desc="Description"/> </dgElements> <uccRecvParms required="false"> <Cnt desc="Max records to read" type="ui4"/> <GetLatest desc="Get latest?" type="boolean"/> <Seq desc="Sequence #" type="ui4"/> <SDate desc="Start date" type="string"/> <EDate desc="End date" type="string"/> </uccRecvParms> </HistEvent>